home *** CD-ROM | disk | FTP | other *** search
/ The Epic Collection 3 / Epic Collection 3, The (1997)(Epic Marketing)[!].iso / useful_tools / magiceye / magiceye.dok < prev    next >
Text File  |  1995-07-29  |  11KB  |  197 lines
  1.         __       __
  2.         )\\     /((  Version 37.2                            __
  3.        /  \\   /  \\         39.2  __         ________      / \\     ________
  4.       /    \\ /    \\              )\\        )      \\    (   ))    )      \\
  5.      / /\   \V /\   \\            /  \\      / ___    \\    \_//    / ___    \\
  6.     / // \    // \   \\          /    \\    / //  \___//     ___   / //  \___//
  7.    / //   \  //   \   \\        / /\   \\  / // _______      ) \\ / //
  8.   / //     \//     \   \\      / /__\   \\ \ \\ \___  \\    /  // \ \\     ____
  9.  / //               \   \\    / ______   \\ \ \\    )  \\  /  //   \ \\    )  \\
  10. / //    @ 1995 by    \   \\  / //     \   \\ \ \\__/   // /  //     \ \\__/   //
  11. \_)) Christian Krapp  \___)) \_))      \___)) \_______//  \_//       \_______//
  12.          sMail:                     eMail:                 _______  ___ _____
  13.      Christian Krapp                                      / __//\ \/ /// __//
  14.      Hagenmähderstr.9   krabbe@informatik.fh-augsburg.de / _//   \  /// _//
  15.    D-86391 Stadtbergen                                  / //__   / /// //__
  16.      (GERMANY)                                          \___//  /_// \___//
  17.                             An AugustA team Release!
  18. --------------------------------------------------------------------------------
  19.  
  20. Copyright:
  21.   Dieses Programm  und alle dazugehörige Dateien (Programm-Icon) sind  Copyright
  22. 1995  bei Christian 'cr8y' Krapp! Es  darf nur  im unveränderten Zustand weiter-
  23. gegeben  werden.  Eine Gebühr, die über den üblichen  Disketten-Preis  zuzüglich
  24. einer geringen Kopiergebühr liegt, darf nicht  erhoben werden.  Desweiteren darf
  25. dieses Programm nicht ohne Genehmigung auf eine PD-Serie oder eine  CD-Rom über-
  26. nommen werden. Diese Genehmigung ist beim Autor erhältlich und wird in der Regel
  27. gegeben.
  28.  
  29.   Nur  für die  AmiNet, FreshFish, und  MeetingPearls  CD-Rom-Serien  sind keine
  30. Genehmigungen nötig.
  31.  
  32.   Dieses Programm  ist weder Public Domain noch Shareware. Es wurde als Freeware
  33. freigegeben.  Jeder der dieses Programm  benutzt sollte mir  eine Postkarte oder
  34. eMail schicken  (Schließlich würde  es mich interessieren, wieviele Leute dieses
  35. Programm benutzen).
  36.  
  37.   Für Schäde,  dir durch  die Benutzung  dieses  Programmes  entstehen, kann der
  38. Autor nicht haftbar gemacht werden. 
  39.  
  40. --------------------------------------------------------------------------------
  41.  
  42. Einführung:
  43.   Nein: Dieses Programm ist kein weiteres Programm zum Berechnen von 3D Bildern.
  44. Jeder Amiga-Benutzer  dürfte inzwischen  MagicWB  (und die  zusatz  Icon-Pakete)
  45. kennen.  Auch dürften die  verschiedenen Gag-Programme  bekannt  sein,  die  ein
  46. Augenpaar auf dem Bildschirm anzeigen, das dem Mauszeiger "verfolgt". Doch eines
  47. hat mich schon immer  gestört: Diese Augen passen nicht ganz zum Rest einer auf-
  48. gepeppten Workbench, da die meisten dieser Augenprogramme mit SW-Augen arbeiten.
  49. Aus diesem  Grund  hab ich mir  die "Arbeit" gemacht  und ein farbiges Augenpaar
  50. erstellt.
  51.  
  52. --------------------------------------------------------------------------------
  53.  
  54. 7 Gründe, dieses Programm zu benutzen:
  55.  
  56. 1.) Die Augen sind Bunt ;^)
  57. 2.) Fenster wird geschlossen, wenn WB geschlossen wird (screennotify.library)
  58. 3.) Viele Parameter sind einstellbar
  59. 4.) Patch, damit sich das Augen-Fenster wie die Screentitelleiste verhält
  60. 5.) 6(!) verschiedene Effekte mit den Augen
  61. 6.) Paßt sich an Farbpalette an, MagicWB wird nicht mehr benötigt (AmigaOS 3.0+)
  62. 7.) Sehr kurzes Programm
  63.  
  64. --------------------------------------------------------------------------------
  65.  
  66. Was wird benötigt?
  67.   Auf jeden  Fall braucht  man einen  Amiga-Computer  (oder kompatibel ;^) ) mit
  68. mindestens AmigaOS  2.04 oder höher. Leider  kann ich nicht garantieren, daß die
  69. Programmversion  für AmigaOS 2.04  funktioniert, da  ich nur  einen  Rechner mit
  70. AmigaOS 3.0  besitze. Desweiteren sollte  die Workbench mit mindestens  8 Farben
  71. und einer  möglichst quadratischen-Auflösung  (z.B. 640×512)  betrieben  werden.
  72. Auch  sollte  möglichst  für  die   Bildschirmtitelleiste  ein  Zeichensatz  mit
  73. mindestens der  Größe 13 benutzt werden,  da ansonsten die Augen über die Titel-
  74. leiste  hinausstehen. Schließlich wird noch die  ScreenNotify-Library von Stefan
  75. Becker benötigt (Das ScreenNotify-Archive liegt bei).
  76.  
  77. --------------------------------------------------------------------------------
  78.  
  79. Die verschiedenen Programm-Versionen:
  80.   Es ist eigentlich sehr einfach: Da  AmigaOS 3.0  einige bessere Funktionen hat
  81. und es  ermöglicht, die  Farben  auf der Workbench zu reservieren, habe ich mich
  82. entschlossen, zwei Versionen  von  MagicEYE  zu erstellen. Eine  für AmigaOS 2.0
  83. (MagicEYE_37) und eine für AmigaOS 3.0 (MagicEYE_39) und höher.
  84.  
  85. --------------------------------------------------------------------------------
  86.  
  87. Wie wird dieses Programm installiert?
  88.   Es  gibt  fast nichts einfacheres als das:  Man muß nur die richtige Programm-
  89. Version in das WBStartup-Verzeichnis der Startdiskette/-festplatte kopieren. Das
  90. wars dann :-]
  91.  
  92. --------------------------------------------------------------------------------
  93.  
  94. Verwendung:
  95.   Dieses Programm kann man NUR(!) von der Workbench (bzw. WBStartup-Verzeichnis)
  96. aus starten.  Wenn man es von  einer Shell  aus  startet, passiert  nichts! Des-
  97. weiteren fehlt dem Programm eine grafische Oberfäche. D.h. alle Parameter müssen
  98. dem Programm mittels ToolTypes im Icon übergeben werden. Folgende ToolTypes sind
  99. vorhanden:
  100.  
  101.   DONOTWAIT       : Dies ist  eigentlich kein  Parameter  für MagicEYE,  sondern
  102.                     viel mehr ein  Schalter  für die  Workbench.  Dieser Eintrag
  103.                     sollte nicht entfernt werden!
  104.   WIN_X           : Mit diesen beiden Parametern wird die Position der Augen auf
  105.   WIN_Y             dem Bildschirm  festgelegt. Dabei wird von der oberen linken
  106.                     Ecke aus positioniert! Die voreingestellten Werte sind:
  107.                     WIN_X=545  und WIN_Y=1
  108.   PRIORITY        : Gibt die Taskpriorität für das System an. Dieser Wert sollte
  109.                     möglichst  unter 0 liegen, damit  Programm,  die  Rechenzeit
  110.                     benötigen diese auch  erhalten. Im  Programm voreingestellte
  111.                     ist der Wert 0, im Icon ist -5 voreingestellt.
  112.   DRAGPATCH       : Mit diesem (NICHT(!)  systemkonformen) Patch ist es möglich,
  113.                     daß man auch mit dem Augen-Fenster den Bildschirm nach unten
  114.                     bzw. zur Seite verschieben kann. Wird dieses Flag angegeben,
  115.                     so ist der  Patch aktiv,  ansonsten wird  dieser Patch nicht
  116.                     durchgeführt.
  117.   SLEEP_PERIOD    : Dieser Parameter gibt an, wie lange es dauert, bis die Augen
  118.                     geschlossen  werden, wenn  die  Maus nicht mehr bewegt wird.
  119.                     Voreingestellt ist ein Wert von 50. (Einfach mal probieren)
  120.   FRESHUP_PER_SEC : Dieser  Wert gibt an, wie oft  in der  Sekunde die Augen neu
  121.                     gezeichnet, und  damit,  wie oft die Pupillen an  die  Maus-
  122.                     position  angepasst werden  soll. D.h. wenn hier 1 angegeben
  123.                     wird, dann  bedeutet  dies, das  MagicEYE einmal pro Sekunde
  124.                     die Augen an  die  aktuelle  Mausposition  anpasst. Als Vor-
  125.                     einstellung wurde 50  gewählt  (=> 50mal pro Sekunde). Werte
  126.                     größer als 100  sind nicht  sinnvoll  (oder hat jemand einen
  127.                     Workbench-Screen  mit  mehr als 100Hz?) und damit auch nicht
  128.                     möglich. Dieser Wert sollte  möglichst gut überdacht werden,
  129.                     da  er vorallem  auch  die von MagicEYE benötigte Systemzeit
  130.                     angibt  (Je größer  der  Wert,  desto  häufiger  werden  von
  131.                     MagicEYE die Augen neu berechnet und gezeichnet).
  132.  
  133. Und nun zu den 'etwas' interessanteren Effekte-Parametern. Dabei ist anzumerken,
  134. daß die angegebenen Werte die  Wahrscheinlichkeit des  Eintretens dieser Effekte
  135. angibt (1/wert). Es sind nur Werte größer als 1 erlaubt:
  136.  
  137.   SLEEPY          : Mit  diesem Parameter kann  man bestimmen, wie oft die Augen
  138.                     blinzeln  sollen.
  139.   TIRED           : Dieser  Parameter  bestimmt,  wie oft  die  Augenlider  halb
  140.                     herunter klappen.
  141.   ROLL_SYNCHRON   : Bestimmt wie Wahrscheinlichkeit, das  die Pupillen der Augen
  142.                     (synchron, d.h. gleiche Richtung) rollen.
  143.   ROLL_ASYNCHRON  : Bestimmt die Wahrscheinlichkeit, das  die Pupillen der Augen
  144.                     (asynchron, d.h. entgegengesetzte Richtung) rollen.
  145.   LEFTRIGHT       : Wie oft sollen die Augen Links-Rechts schauen?
  146.   RANDOM_EYE      : Gibt an, wie oft die Augen zittern.
  147.   BLOODY          : Bestimmt, wann die Augen rot unterlaufen.
  148.  
  149.   So, daß wäre  eigentlich alles, was man zu diesem Tool wissen müsste. Oder...?
  150. Ach, ich hab noch nicht erzählt, wie man das Programm  beendent? Nun, eigentlich
  151. meine  ich,  daß dieses Programm auf jede 8 Farben Workbench  gehört. Wenn  aber
  152. jemand dieses Programm  beenden will, dann kann er dies wiefolgt machen: Fenster
  153. aktivieren  (mit der linken  Maustaste  Fenster  anwählen (auf  eines der  Augen
  154. klicken)) und dann die rechte Maustaste drücken (eventuell öfters).
  155.  
  156. --------------------------------------------------------------------------------
  157.  
  158. Was kann man an dem Programm noch verbessern?
  159.   * Man kann noch ein paar Spielereien  mit den Augen machen.
  160.   * Man kann das Programm zu einem Commodity ausbauen
  161.   * Man kann noch Augenbrauen einfügen
  162.   * Man kann davon  ausgehen,  das  noch  irgendwelche  Fehler  (undokumentierte
  163.     Möglichkeiten oder gar Käfer ;^) ) enthalten sind, die man entfernen sollte.
  164.  
  165. --------------------------------------------------------------------------------
  166.  
  167. Wer Verbesserungsvorschläge,  Fehler usw. hat, der  kann sollte sich an folgende
  168. Adresse wenden:
  169.  
  170.                  sMail:           Christian Krapp
  171.                                   Hagenmähderstr. 9
  172.                                 D-86391 Stadtbergen
  173.                                   (GERMANY)
  174.                  eMail:           krabbe@informatik.fh-augsburg.de
  175.  
  176. --------------------------------------------------------------------------------
  177.  
  178. Geschichtliches: (xx steht entweder für 37 (AmigaOS 2.04) bzw. 39 (AmigaOS 3.0))
  179.  
  180. Vxx.0   28.04.1995 - Die ersten Arbeiten an dem Programm beginnen (Animationen).
  181. Vxx.1   16.06.1995 - Nach langer Arbeit (und erneutem erstellen der Animationen)
  182.                      ist die erste brauchbare Version fertig.
  183. Vxx.2   xx.xx.1995 - Ein etwas komischer  Fehler wurde behoben  (Danke an Roland
  184.                      Fulde).
  185.                    - Farbanpassung  implementiert  (Nachdem sich Markus Speicher
  186.                      und Mario  Cattaneo  als  einzige dafür interessiert haben,
  187.                      nur 37.x-Version).
  188.                    - ScreenNotify-Library   wird  unterstützt  (Idee  von  Mario
  189.                      Cattaneo).
  190.                    - Augenrollen (Idee von Dirk Wrocklage).
  191.                    - Zitternde  und rot  unterlaufene  Augen (Idee  von  Michael
  192.                      Krapp).
  193.                    - Augenrollen Asynchron, müde  Augen und Links-Rechts schauen
  194.                      (Idee von Christian Krapp)
  195.  
  196. --------------------------------------------------------------------------------
  197.